home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / netroute.man < prev    next >
Encoding:
Text File  |  1992-06-30  |  7.2 KB  |  201 lines
  1.  
  2.  
  3.  
  4. NETROUTE                  User Commands                  NETROUTE
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      netroute - Set up host names, addresses, and machine types
  12.  
  13. SSYYNNOOPPSSIISS
  14.      nneettrroouuttee  [ooppttiioonnss]
  15.  
  16. OOPPTTIIOONNSS
  17.      [none]
  18.           Print out the kernel's route table.
  19.  
  20.      --hh _h_o_s_t
  21.           The host to operate upon. Either a hostname  or  Sprite
  22.           ID.
  23.  
  24.      --ff _f_i_l_e
  25.           Use given file for the Sprite host database.
  26.  
  27.      --gg _f_i_l_e
  28.           Use given file for the Sprite gateway database.
  29.  
  30.      --ffaavvoorr _n_e_t
  31.           Try to establish routes across networks of type _n_e_t.
  32.  
  33.      --ddiissffaavvoorr _n_e_t
  34.           Try not to establish routes  across  networks  of  type
  35.           _n_e_t.
  36.  
  37.      --eetthheerr _f_f:_o_o:_o_o:_b_b:_a_a:_r_r@_a_a._b_b._c_c._d_d    Establish a route to
  38.                                              a  host  with  these
  39.                                              ethernet and  inter-
  40.                                              net addresses.
  41.  
  42.      --uullttrraa _h_h/_i_i@_a_a._b_b._c_c._d_d                Establish a route to
  43.                                              a  host  with  these
  44.                                              ultranet and  inter-
  45.                                              net addresses.
  46.  
  47.      --ffddddii _q_q:_w_w:_e_e:_r_r:_t_t:_y_y@_a_a._b_b._c_c._d_d     Establish a route to
  48.                                              a  host  with  these
  49.                                              fddi  and   internet
  50.                                              addresses.
  51.  
  52.      --pp   Print routes.
  53.  
  54.      --ii   Install routes. This is the default  operations  if  no
  55.           operations are given.
  56.  
  57.      --dd _r_o_u_t_e_I_D
  58.           Delete the route with the given ID.
  59.  
  60.  
  61.  
  62.  
  63. Sprite v.1.0         Printed:  June 30, 1992                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. NETROUTE                  User Commands                  NETROUTE
  71.  
  72.  
  73.  
  74.      --mm _m_a_c_h_i_n_e__t_y_p_e
  75.           Host's machine type, where the host is specified by the
  76.           --hh option.
  77.  
  78.      --vv   Verbose.
  79.  
  80.      --nn   Print actions instead of doing them.   Not  fully  sup-
  81.           ported yet.
  82.  
  83. _________________________________________________________________
  84.  
  85. IINNTTRROODDUUCCTTIIOONN
  86.      This command is used to access the kernel's  internal  route
  87.      table.   This  route  table  is used to determine routes for
  88.      sending RPC packets between the hosts. The route  table  has
  89.      nothing  to  do  with  user-level  network communication via
  90.      TCP/IP or similar protocols.  Normally nneettrroouuttee  is  invoked
  91.      during  the  boot  script to install routes to all the hosts
  92.      found in /etc/spritehosts (/etc/spritehosts.new  during  the
  93.      transition  period  to the new spritehosts file format). The
  94.      /etc/spritehosts file contains the spriteID of the  host,  a
  95.      network  type  and  address  (i.e.  ethernet),  an  internet
  96.      address, a machine type, and a name plus  optional  aliases.
  97.      The  spriteID  is  used  internally  for  RPC  communication
  98.      between Sprite hosts.  The network type and network  address
  99.      are  used  to map the Sprite ID to the correct local network
  100.      address.  The internet address is used for the internet pro-
  101.      tocols.   The machine type is used when expanding the string
  102.      ``$MACHINE'' inside pathnames.  The file  server  must  know
  103.      its  clients  machine  types  in order to do this correctly.
  104.      The names are used to make console error messages contain  a
  105.      human  understandable  host name, and are also used with the
  106.      internet library routines.
  107.  
  108. UUSSAAGGEE
  109.      There are three operations that can be performed on  routes.
  110.      One  is  to  print them, another is to install them, and the
  111.      last is to delete them.  These operations are specified with
  112.      the pp, ii and dd options.
  113.  
  114.  
  115. IINNSSTTAALLLLIINNGG RROOUUTTEESS
  116.      For installing hosts, the information is normally taken from
  117.      a  host database file.  A host can be installed from scratch
  118.      by  specifying  its  name  (hhRR  ooppttiioonn)),,  mmaacchhiinnee  ttyyppee  ((mmRR
  119.      ooppttiioonn)),,  aanndd  nneettwwoorrkk aaddddrreesssseess..  TThhee nneettwwoorrkk aaddddrreesssseess aarree
  120.      ssppeecciiffiieedd uussiinngg tthhee eetthheerrRR,, uullttrraa, and  ffddddii  options.   The
  121.      strings  passed  to  these  options  must  be  of  the  form
  122.      _n_e_t__a_d_d_r_e_s_s@_i_n_e_t__a_d_d_r_e_s_s because each network interface  has
  123.      both  a  network  address and an internet address.  At least
  124.      one must be specified.
  125.  
  126.      Routes to hosts can be installed only over one network type.
  127.      When  they  are  installed, nneettrroouuttee uses a list of types to
  128.  
  129.  
  130.  
  131. Sprite v.1.0         Printed:  June 30, 1992                    2
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. NETROUTE                  User Commands                  NETROUTE
  139.  
  140.  
  141.  
  142.      check in a predefined order (use the vv option to  find  this
  143.      order.)  It  will  try  to establish a route using the first
  144.      network type; if that fails, it  will  try  the  next,  etc.
  145.      This  list  can  be  changed dynamically using the ffaavvoorr and
  146.      ddiissffaavvoorr options to either favor one network  type  most  or
  147.      one  network type the least, respectively.  Both options can
  148.      be used at the same time.
  149.  
  150.      For example, normally routes are installed over ethernet. To
  151.      change  it so that fddi routes are installed where possible,
  152.      use:
  153.  
  154.      % netroute -i -favor fddi
  155.  
  156.      This will install fddi routes to those machines that support
  157.      fddi routes, and ethernet routes to the remainder.
  158.  
  159.      When new routes are  installed  successfully,  the  previous
  160.      route is removed.
  161.  
  162.  
  163. DDEELLEETTIINNGG RROOUUTTEESS
  164.      Routes are deleted by specifying a  route  ID  using  the  dd
  165.      option.
  166.  
  167.  
  168. PPRRIINNTTIINNGG RROOUUTTEESS
  169.      When routes are printed, the following information is  given
  170.      about  each  route:  the  Sprite ID of the host to which the
  171.      route goes; the hostname and the machine type of that  host;
  172.      a  description  of  the route from the kernel; the route ID,
  173.      and the route ID shifted by right by 16 places; the  network
  174.      type  of  the  route;   the network address of the interface
  175.      from which the route sends packets;  the protocol  that  the
  176.      route  serves;  the  route  flags;  a reference count to the
  177.      route; min and max packet sizes over the route; min and  max
  178.      RPC  sizes  over  the  route; and the network address of the
  179.      destination host to which packets are sent.
  180.  
  181.  
  182. FFIILLEESS
  183.           //eettcc//sspprriitteehhoossttss    Contains the old host database
  184.           //eettcc//sspprriitteehhoossttss..nneeww Contains the new host database.
  185.  
  186. KKEEYYWWOORRDDSS
  187.      ethernet, ultranet, fddi, internet, net, route, $MACHINE
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197. Sprite v.1.0         Printed:  June 30, 1992                    3
  198.  
  199.  
  200.  
  201.